Function: off(domElementOrNodeArrayOrCSSSelector, stringEventName)

Description: Removes previously bound event handlers.

Returns: domElement or matching node array, or $A object if chained.

Note: The event naming syntax also supports event namespacing, so that multiple events can be removed using the same namespace for grouped events. Bound data assigned through the on() function will also be removed.

Example:

// Remove all event handlers from a DOM element.
var myElement = $A.off(domElement);

// Remove a specific event handler from a DOM element.
var myElement = $A.off(domElement, "click");

// Remove multiple events from DOM elements referenced with a CSS selector.
var myElementsArray = $A.off("a.tooltip-trigger", "focus mouseover");

// Remove namespaced events from a DOM element.
var myElement = $A.off(domElement, ".myNamespace");

// Remove namespaced events from an array of DOM elements.
var myElementsArray = $A.off([domElement1, domElement2], ".myNamespace");

// Or the same using chaining

// Remove all event handlers from a DOM element.
var myChain = $A(domElement).off();

// Remove a specific event handler from a DOM element.
var myChain = $A(domElement).off("click");

// Remove multiple events from DOM elements referenced with a CSS selector.
var myChain = $A("a.tooltip-trigger").off("focus mouseover");

// Remove namespaced events from a DOM element.
var myChain = $A(domElement).off(".myNamespace");

// Remove namespaced events from an array of DOM elements.
var myChain = $A([domElement1, domElement2]).off(".myNamespace");

// To return the modified element within a chain, use the "return()" method.

var myElement = myChain.return();